<h4>Tool</h4><table border="0"><tr><td valign="top"><b>Name</b></td><td valign="top">Import Point Cloud from Text File</td></tr><tr><td valign="top"><b>ID</b></td><td valign="top">16</td></tr><tr><td valign="top"><b>Author</b></td><td valign="top">V. Wichmann, LASERDATA GmbH (c) 2009</td></tr></table><hr><h4>Description</h4>Creates a point cloud from a text file.
The input file must have at least three columns holding the x, y, z coordinates of each point. You must specify the field numbers of these. In case you like to import additional attributes, you have to provide the number of attribute fields. After tool execution, you will be prompted to provide their field numbers, names and datatypes.
You have also to decide on which field separator to use and if the first line of the input file should be skipped (in case it contains column headings).
The columns in the input file can be in any order, and you can omit columns, but you have to provide the correct field numbers of those you like to import.

Tool usage is different between SAGA GUI and SAGA CMD: With SAGA GUI you will get prompted to choose the fields to export, and to provide the field names and datatypes to use once you execute the tool.
 With SAGA CMD you have to provide three strings with the -FIELDS, -FIELDNAMES and -FIELDTYPES parameters. The first one must contain the field numbers, the second one the field names and the third one the choices of the datatype (see the GUI which number equals which datatype). Each field entry has to be separated by semicolon. Field numbers start with 1, e.g. -FIELDS="5;6;8" -FIELDNAMES="intensity;class;range" -FIELDTYPES="2;2;3".

<hr><h4>Parameters</h4><table border="1" width="100%" valign="top" cellpadding="5" rules="all"><tr><th>Name</th><th>Type</th><th>Identifier</th><th>Description</th><th>Constraints</th></tr>
<tr><th colspan="5">Output</th></tr><tr><td>Point Cloud (*)</td><td>Data Object (optional output)</td><td>POINTS</td><td></td><td></td></tr><tr><th colspan="5">Options</th></tr><tr><td>Text File</td><td>File path</td><td>FILE</td><td></td><td></td></tr><tr><td>X is Column ...</td><td>Integer</td><td>XFIELD</td><td>The column holding the X-coordinate.</td><td>Minimum: 1
Default: 1</td></tr><tr><td>Y is Column ...</td><td>Integer</td><td>YFIELD</td><td>The column holding the Y-coordinate.</td><td>Minimum: 1
Default: 2</td></tr><tr><td>Z is Column ...</td><td>Integer</td><td>ZFIELD</td><td>The column holding the Z-coordinate.</td><td>Minimum: 1
Default: 3</td></tr><tr><td>Fields</td><td>Text</td><td>FIELDS</td><td>The numbers (starting from 1) of the fields to import, separated by semicolon, e.g. "5;6;8"</td><td></td></tr><tr><td>Field Names</td><td>Text</td><td>FIELDNAMES</td><td>The name to use for each field, separated by semicolon, e.g. "intensity;class;range"</td><td></td></tr><tr><td>Field Types</td><td>Text</td><td>FIELDTYPES</td><td>The datatype to use for each field, separated by semicolon, e.g. "2;2;3;". The number equals the choice selection, see GUI version.</td><td></td></tr><tr><td>Skip first line</td><td>Boolean</td><td>SKIP_HEADER</td><td>Skip first line as it contains column names.</td><td>Default: 0</td></tr><tr><td>Field Separator</td><td>Choice</td><td>FIELDSEP</td><td>Field Separator</td><td>Available Choices:
[0] tabulator
[1] space
[2] comma
Default: 0</td></tr></table>(*) <i>optional</i>